home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 25 / Mac Magazin and MacEasy Magazine CD - Issue 25.iso / Online / Joe's-PPP-Scripts / PPP Connection / ReadMe < prev   
Text File  |  1996-08-21  |  5KB  |  99 lines
  1. •PPP Connection  v 0.2
  2. Copyright ©1996 Joseph Santaniello. All Rights Reserved.
  3.  
  4. Who it's for:
  5.  
  6. This AppleScript is for PPP users with non-static IP addresses, i.e. dial-up modem users,
  7. who would like a means of publicizing their current IP address while logged-on so they
  8. can be contacted with Maven, PGPFone, Talk, or whatever, with minimal hassle.
  9.  
  10. What it does:
  11.  
  12. This AppleScript opens a PPP link. When it opens a connection it checks if you have E-mail.
  13. It then uses Text-to-Speech to let you know how many messages you have, if any. Then it
  14. ftp's an HTML file of your choice to your chosen directory substituting your current IP
  15. address and the current time for certain special characters it finds in the text file. It
  16. saves this file as "currentIP.html". You may name your file whatever you wish. 
  17. The script then ftp's a ".forward" file directing your mail server to contact your
  18. machine on port "666" when new mail arrives. You may name your file whatever you wish.
  19. This all usually takes about 10 seconds, during which time you may switch to or open other applications.
  20. The script then proceeds to listen on port "666" for a connection, when a connection is
  21. detected, Text-to-Speech advises you of the new E-mail (takes about 5 seconds).When you
  22. wish to close your PPP connection, switch to "•PPP Connection" and quit from the File menu.
  23. When the script closes a connection it first ftp's another HTML file, again substituting IP address and
  24. current time for certain special characters. This way people can always get you current 
  25. log-on status. See below for more on configuration and sample files.
  26.  
  27. What it requires:
  28.  
  29. This script as yet has only been tested on with System 7.5.3 and FreePPP 2.5.
  30. It does not work properly with OpenTransport.  AppleScript v1.0 or later, Drag and Drop, 
  31. Scriptable finder, InternetConfig, and the following Scripting Additions are required: 
  32.  
  33. MacPPP Control OSAX  found in UMich mirrors such as:
  34. ftp://mac.uio.no//umich/util/comm/macpppcontrol1.4.sit.hqx
  35.  
  36. TCP/IP Scripting Additions OSAX found in UMich mirrors such as: ftp://mac.uio.no//umich/util/script/tcpipscriptingadd1.12.cpt.hqx
  37.  
  38. Speech OSAX found in Info-Mac mirrors such as:
  39. ftp://mac.uio.no//info-mac/cfg/speech-as.hqx
  40.  
  41. Jon's Commands OSAX found in Info-Mac mirrors such as:
  42. ftp://mac.uio.no//umich/util/script/jonscommands1.36.sit.hqx
  43.  
  44. ICScriptor OSAX found in Info-Mac mirrors such as:
  45. ftp://mac.uio.no//umich/util/script/icscriptor1.0b1.sit.hqx
  46.  
  47. InternetConfig may be found in Info-Mac mirrors such as:
  48. ftp://mac.uio.no//info-mac/_Internet/internet-config-12.hqx
  49. Be certain it is properly set up before trying the script.
  50. (if you were really cool you would have the ICeTEe Extension which comes with IC installed)
  51.  
  52. How to set it up:
  53.  
  54. First make two HTML files named whatever you wish. The Script automatically names either
  55. file "currentIP.html" when it up-loads it.  "openingFile" & "closingFile" are logical choices.
  56. These files can be as long as you wish (I think). The Script will substitute the current IP address
  57. everywhere it finds the string "%ip%" and the current time/date everywhere it finds the
  58. string "%clock%" (no quotes). A sample opening file might be:
  59.  
  60. <HTML><HEAD>
  61. <TITLE>Current IP Address</TITLE>
  62. </HEAD>
  63. <BODY>
  64. <BR><BR><BR><BR>
  65. <H3>%ip%</H3>
  66. Is my current IP address. Talk requests are welcomed.
  67. <BR><BR><BR><BR><BR>
  68. I have currenty been online since: %clock%
  69. </BODY>
  70. </HTML>
  71.  
  72. A sample closing file might be similar: "I logged-off at %clock%, sorry." blah, blah, blah.
  73.  
  74. Next modify the enclosed forward file to reflect you own email address, where "USER" is
  75. replaced by your username (the first part of your e-mail address):
  76.  
  77. \USER,
  78. "| echo quit | ftp %ip% 666"
  79.  
  80. (The script could have managed this without an external forward file being
  81. required, but this allows for some customization for different set-ups.)
  82.  
  83. The first time you run the script you will be prompted to locate your two HTML files,
  84. and do specify a directory to store them in. A blank field send them to you default directory.
  85. Next you must select your "forward file". The script will rember these files' locations.
  86. The script will now do its thing. When you want to close your connection, just quit and
  87. the script will upload the closeFile and then close the PPP link.
  88.  
  89. Now what?
  90.  
  91. This Script is free. You are required to send me e-mail with comments, however.
  92.  
  93. This Script may be included in CD-ROM collections if this documentation is included,
  94. and if possible I am given a copy. This Script is warranted to do nothing. If it doesn't
  95. do nothing you can have your money back. Or maybe I can have your money back...?
  96.  
  97. Joseph Santaniello <cvoss@sn.no>                     http://www.sn.no/~cvoss/
  98.  
  99.